home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BUSINESS / BAM300.ARJ / SASK.DOC < prev    next >
Text File  |  1991-03-18  |  5KB  |  113 lines
  1. --------------------------------------------------------------------------
  2. Version 1.32                       SupremeAsk                     02/25/90
  3. Copyright (c) 1988-90 by SupremeSoft                   All Rights Reserved
  4. --------------------------------------------------------------------------
  5.  
  6.   SASK is simply a Norton ASK clone. It has one added feature, the
  7. ability to import text files as the prompts. This allows you to display
  8. all those README files, and then request the user if they want to follow
  9. a certain course of action. All you have to do is add the prompt at the
  10. end of the README file.
  11.  
  12.   SASK automatically keeps track of the current display line, thus
  13. allowing you to display files which are more than 24 lines long. SASK
  14. will display "More...Press any key" at the end of each page. Naturally,
  15. if the display doesn't overrun one page, no such prompt is made.
  16.  
  17. Calling Syntax:      SASK ["Display Prompt" | filename.txt]  KeyList
  18.  
  19.   You have the option to output a standard prompt, just as in Norton's
  20. ASK. To do so, just enclose the prompt in double quotes ("). (See note
  21. for C version), the program will then display that prompt and wait for
  22. one of the keys in KeyList to be entered.
  23.  
  24. Returns:        ERRORLEVEL set according to the key pressed, and it's
  25.                   location in the KeyList
  26.  
  27.                 ERRORLEVEL set to 99 on any Errors including
  28.                 Ctrl-C/Ctrl-Break.
  29.  
  30. Examples:   SASK "Continue? (Y/N)" yn
  31.  
  32.       Displays <Continue? (Y/N)> and waits for either <Y>, <y>, <N>, <n>
  33. to be pressed. ERRORLEVEL is set as follows:
  34.  
  35.              <Y>,<y>      ERRORLEVEL=1
  36.              <N>,<n>      ERRORLEVEL=2
  37.              Any error    ERRORLEVEL=99
  38.  
  39.  
  40.             SASK readme.txt nye
  41.  
  42.       Displays the file README.TXT and waits for <Y>, <y>, <N>, <n>,
  43. <E>, <e>. ERRORLEVEL is returned as follows:
  44.  
  45.              <N>,<n>      ERRORLEVEL=1
  46.              <Y>,<y>      ERRORLEVEL=2
  47.              <E>,<e>      ERRORLEVEL=3
  48.              Any error    ERRORLEVEL=99
  49.  
  50.  
  51.  
  52. Note 1:  To test ERRORLEVEL in batch files, make sure that you test for
  53. the HIGHEST possible return value FIRST! Otherwise, the batch file will
  54. execute the very first condition. Therefore use the following
  55. construct:  
  56.  
  57.            if ERRORLEVEL=99
  58.            if ERRORLEVEL=98
  59.            if ERRORLEVEL=97
  60.                   .
  61.                   .
  62.                   .
  63.            if ERRORLEVEL=1
  64.  
  65.  
  66. Check your DOS manual for further information.
  67.  
  68. Note 2: For the C versions, instead of using double quotes, you must use
  69. single quotes (').
  70.  
  71. Note 3: Unlike Norton ASK, the program does not Beep at an incorrect key
  72. entry. Also, unlike ASK, the program will ALWAYS display it's copyright
  73. notice
  74. ---------------------------------------------------------------------------
  75. Changes since version 1.31:
  76.  
  77. The C versions are now also being distributed, and are on the disk as 
  78. SASK2.EXE and SASK3.EXE. SASK2 is the version optimized for 
  79. 80186/80286/80386/80486 processors, though not suitable for running under 
  80. OS/2. SASK3 is the 8086/808 processor version.
  81.  
  82. The C versions are slightly bigger in size, but take up less memory, and 
  83. tend to run a bit faster. The choice of which version (Pascal or C) to use 
  84. is left up to you.
  85.  
  86. There was only one small error in the program, thus the reason for not 
  87. updating it for over two years. When you typed SASK by itself to get the 
  88. calling syntax, the program told you that ERRORLEVEL was set from the KeyList 
  89. from right to left. This was WRONG. It is actually from left to right.
  90. ---------------------------------------------------------------------------
  91. License/Warranty:
  92.  
  93.      There is NO warranty either expressed or implied. You use this
  94. program at your own risk! You may NOT hold SupremeSoft accountable for
  95. any damages that may occur either directly or indirectly from the use of
  96. this program.
  97.  
  98.      This program is distributed either by itself, or in a package of 
  99. Utilities. To register SupremeAsk and to get a copy of the latest versions of 
  100. all the Utilities send $5.00 to the address below:
  101.  
  102.                            SupremeSoft
  103.                            105 Deerfield Drive
  104.                            Easton, CT 06612
  105.  
  106.  
  107. Corporate/Academic Site Licenses are available.
  108. ---------------------------------------------------------------------------
  109. SupremeSoft is a Trademark of SupremeSoft in Easton CT.
  110. SupremeAsk  is a Trademark of SupremeSoft.
  111. ASK  is a Registered Trademark of Norton Computing.
  112. ---------------------------------------------------------------------------
  113.